home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / com / others / mad_sys / _fremd / unzip.ttp / unzip.doc < prev   
Text File  |  1990-12-31  |  6KB  |  164 lines
  1.   
  2.                                 UnZip ST
  3.   
  4.                          Version 2.0.5, 01-Dec-90
  5.   
  6.                         Zipfile Processing Utility
  7.   
  8.           Copyright (C) 1989 Samuel H. Smith;  ALL RIGHTS RESERVED
  9.           Copyright (C) 1990 William K. Day;  ALL RIGHTS RESERVED
  10.  
  11.                     ST Version courtesy of William K. Day
  12.                         FNET Node 398  (708) 695-8617
  13.   
  14. 'UnZip' is a small Zipfile processing utility.  It allows verbose
  15. listing, extraction, and recommenting of ZIP files.
  16.  
  17. Source code is provided in C for the ST version and the original
  18. portable version.
  19.  
  20. The original C module (unzip.org) is meant to be as portable as possible.  
  21.  
  22. Usage
  23. -----
  24.    unzip {xvlnc} filename[.zip] <path>
  25.  
  26.    where:
  27.            x is to extract from the filename[.zip] file to the
  28.              optional path.  If there is no path specified the
  29.              current directory is used.
  30.  
  31.            v is to verbose list the contents of the filename[.zip]
  32.              to the screen.
  33.  
  34.            l is the same as v.
  35.  
  36.            c is the add zip file comments command.  This command allows
  37.              the user to add zip file comments to an existing zip file
  38.              archive.  The syntax of this command is as follows:
  39.                   unzip.ttp c zipfile.zip comment.txt
  40.              The comment.txt file is a small text file that you wish
  41.              to add to the zip file as a file level comment.  Make sure
  42.              it is readable text.  This file is not filtered for graphics
  43.              in any way.
  44.  
  45.            n is to suppress comment display in either extract or list
  46.              modes.  The command parameters should look like:
  47.                   unzip.ttp xn zipfile.zip e:\work\*.*
  48.              This works well with the ARCSHELL "Suppress Notes" menu selection.
  49.  
  50.            filename[.zip] is the ZIP file to operate upon.  The
  51.              ending .ZIP is assumed if not provided.
  52.  
  53.            [path] is the optional path to extract the contents
  54.              of the .ZIP file to.  If none is provided the current
  55.              folder is used and all files are extracted.  Wildcarding
  56.              of the following types are allowed:
  57.  
  58.              *.*      Where all files are extracted.
  59.              *.ext    Where any file matching the ext extension is extracted.
  60.              file.*   Where any file matching the file part with any ext
  61.                       is extracted.
  62.              file.ext Where only the file with the name file.ext is extracted.
  63.  
  64.              Any leading path like E:\WORK\*.* must exist prior to execution.
  65.  
  66. Revision history
  67. ----------------
  68.  
  69. 3-3-89
  70.    Initial alpha test release.
  71.  
  72. 3-5-89
  73.    First fully operational release.  Does not implement CRC verification,
  74.    but should correctly unzip all compression methods.
  75.  
  76. 3-6-89
  77.    Corrected end-of-file detection in both shrink and reduce expanders.
  78.    Resulting files should now always have the correct size.  Added ".ZIP"
  79.    default to unzip.c to match calling conventions of unz.pas.
  80.  
  81. 3-8-89
  82.    Moved machine and operating-system specific code to a block starting
  83.    around line 180.  Added code to swap bytes on host machines that
  84.    store the high order bytes in lower address locations than the low
  85.    order bytes.
  86.  
  87. 3-15-89
  88.    Added CRC checking in UNZIP.C.  Speeded operation by about 150%.
  89.  
  90.    I'm spending my time on the C version now and don't plan to do any
  91.    further work on the pascal.  If you're using the pascal version
  92.    please contact me.
  93.  
  94. 9-9-89
  95.    Addition of new "un-implode" logic to handle new compression format
  96.    included with PKZ101.
  97.  
  98. 9-16-89
  99.    Portable version created by George M. Sipe (rebel!george).  Should
  100.    now more easily be ported to other systems and compilers.
  101.  
  102. 10-28-90  William K. Day  (2.0.0)
  103.    Modified for use on the Atari ST TOS operating system.
  104.  
  105.    Added the ability to verbose list a ZIP file.
  106.  
  107.    Added the ability to extract to a provided folder.
  108.  
  109. 10-30-90  William K. Day  (2.0.1)
  110.    Added the ability to use under arcshell by ignoring the trailing
  111.    *.* on the end of the command line during extract.
  112.  
  113. 11-25-90  William K. Day  (2.0.2)
  114.    Corrected a bug in dealing with Zip Comments.  The reserved space
  115.    was not large enough.  Used malloc to create a buffer of the exact
  116.    size necessary.
  117.  
  118.    Added the printout of the Zip Comments if they exist in both Verbose
  119.    List and Extract modes.
  120.  
  121. 11-29-90  William K. Day  (2.0.3)
  122.    Added wildcarding to the extraction side.
  123.  
  124. 11-30-90  William K. Day  (2.0.4)
  125.    Added the ability to verbose list with the l command (from ARCSHELL).
  126.    Also added the ability to suppress the display of zip comments
  127.    using the n switch (also from ARCSHELL).
  128.  
  129. 12-01-90  William K. Day  (2.0.5)
  130.    Added the ability to change the file level ZIP comment.  This can
  131.    be used to customize your ZIP files like those IBM people do.
  132.  
  133.  
  134. LICENSE
  135. =======
  136.  
  137. You may copy and distribute this program freely, provided that:
  138.  
  139.     1)   No fee is charged for such copying and distribution.
  140.     2)   The source code is left with the program.
  141.  
  142. If you wish to distribute a modified version of this program, you MUST
  143. include the source code.
  144.  
  145. Since this code has been so extensively modified, the only parts that
  146. are left in the ST version from the original are the actual UNZIPing
  147. code.  The user interface have been completely rewritten from scratch.
  148.  
  149.  
  150. SUPPORT
  151. =======
  152.  
  153. Bug reports and comments for those versions supplied by William K. Day
  154. should be forwarded to the following addresses:
  155.  
  156. William K. Day
  157. 1250 Leawood Court
  158. Elgin, IL  60120
  159. (708) 695-7252
  160.  
  161. Dragon's Egg II BBS
  162. (708) 695-8617
  163. FNET Node 398
  164.